home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / MUTEX_LOCK.z / MUTEX_LOCK
Encoding:
Text File  |  1998-10-30  |  4.5 KB  |  66 lines
  1.  
  2.  
  3.  
  4. MMMMUUUUTTTTEEEEXXXX____LLLLOOOOCCCCKKKK((((DDDD3333))))                                                  MMMMUUUUTTTTEEEEXXXX____LLLLOOOOCCCCKKKK((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK - acquire a mutual exclusion lock
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_kkkk_ssss_yyyy_nnnn_cccc_hhhh_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _vvvv_oooo_iiii_dddd _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK_((((_mmmm_uuuu_tttt_eeee_xxxx______tttt _****_l_o_c_k_p, int _p_r_i_o_r_i_t_y);
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _l_o_c_k_p     Pointer to the mutual exclusion lock to be acquired.
  18.  
  19.      _p_r_i_o_r_i_t_y  Reserved for future use (must be equal to -1).
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK acquires the mutual exclusion lock specified by _l_o_c_k_p.  If the
  23.      lock is not immediately available, the calling thread of execution blocks
  24.      until the lock becomes available to the caller, at which point the caller
  25.      is reactivated and returns with the lock held.
  26.  
  27.      The caller will not be interrupted by signals while sleeping inside
  28.      _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK.
  29.  
  30.      _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK differs from _SSSS_LLLL_EEEE_EEEE_PPPP______LLLL_OOOO_CCCC_KKKK in that it implements priority
  31.      inheritance -- the owner of the lock inherits the scheduling priority of
  32.      any callers waiting for the lock if any of the waiters are running at a
  33.      higher priority than the owner.  The original priority is reinstated when
  34.      the lock is released.
  35.  
  36.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  37.      None
  38.  
  39.    LLLLeeeevvvveeeellll
  40.      Base only.
  41.  
  42.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  43.      Can sleep.
  44.  
  45.      Driver-defined basic locks may not be held across calls to this function.
  46.  
  47.      Driver-defined sleep locks may be held across calls to this function
  48.      subject to the recursion restrictions described below.
  49.  
  50.    WWWWaaaarrrrnnnniiiinnnnggggssss
  51.      Mutual exclusion locks are not recursive -- a call to _MMMM_UUUU_TTTT_EEEE_XXXX______LLLL_OOOO_CCCC_KKKK
  52.      attempting to acquire a lock that is currently held by the calling thread
  53.      of execution will result in deadlock.
  54.  
  55. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  56.      _MMMM_UUUU_TTTT_EEEE_XXXX______AAAA_LLLL_LLLL_OOOO_CCCC(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______IIII_NNNN_IIII_TTTT(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______DDDD_EEEE_AAAA_LLLL_LLLL_OOOO_CCCC(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______DDDD_EEEE_SSSS_TTTT_RRRR_OOOO_YYYY(D3),
  57.      _MMMM_UUUU_TTTT_EEEE_XXXX______TTTT_RRRR_YYYY_LLLL_OOOO_CCCC_KKKK(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______UUUU_NNNN_LLLL_OOOO_CCCC_KKKK(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______OOOO_WWWW_NNNN_EEEE_DDDD(D3), _MMMM_UUUU_TTTT_EEEE_XXXX______MMMM_IIII_NNNN_EEEE(D3),
  58.      _SSSS_LLLL_EEEE_EEEE_PPPP______LLLL_OOOO_CCCC_KKKK(D3).
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.